package com.mapper;

import com.bean.Order;
import org.apache.ibatis.annotations.Mapper;

import java.util.List;

@Mapper
public interface OrderMapper {
    /**
     * 根据订单 ID 获取订单信息
     * @param orderId 订单的唯一标识
     * @return 订单对象，如果未找到则返回 null
     */
    Order getOrderById(Integer orderId);

    /**
     * 分页模糊查询用户的订单信息
     * @param userId 用户的唯一标识
     * @param keyword 模糊查询关键字，可匹配订单状态
     * @param offset 分页偏移量
     * @param limit 每页记录数
     * @return 订单列表
     */
    List<Order> getOrdersByUserIdWithKeyword(Integer userId, String keyword, int offset, int limit);

    /**
     * 统计用户符合模糊查询条件的订单数量
     * @param userId 用户的唯一标识
     * @param keyword 模糊查询关键字，可匹配订单状态
     * @return 订单数量
     */
    int countOrdersByUserIdWithKeyword(Integer userId, String keyword);

    /**
     * 插入新的订单信息
     * @param order 订单对象
     * @return 插入操作影响的行数
     */
    int insertOrder(Order order);

    /**
     * 根据订单 ID 更新订单信息
     * @param order 订单对象
     * @return 更新操作影响的行数
     */
    int updateOrder(Order order);

    /**
     * 根据订单 ID 删除订单信息
     * @param orderId 订单的唯一标识
     * @return 删除操作影响的行数
     */
    int deleteOrderById(Integer orderId);
}